Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

Functions / Creating and Managing Job Objects

GXDisposeJob

You can use the GXDisposeJob function to dispose of a job object associated with a printable document.

OSErr GXDisposeJob (gxJob aJob);

aJob

A reference to the job object to be disposed of.

function result

An error code of type OSErr.

DESCRIPTION

You should call the GXDisposeJob function when a user closes a printable document and deallocates space for an existing job object. This function returns an error if the specified job object is nil.

Before you dispose of a job object, you should call the GXFlattenJobToHdl function or the GXFlattenJob function to save a job object when a user saves a document.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

Listing 2-9 on page 2-29 shows how to use the GXDisposeJob function to dispose of a job object when a user closes a document.

The GXFlattenJobToHdl function for saving job objects in a handle is described in the next section. The GXFlattenJob function for saving job objects by calling a function is described on page 2-57.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help